home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / forth / jx4a0317.lzh / READ_1ST.TXT < prev   
Text File  |  1994-05-17  |  7KB  |  212 lines
  1. Jax4th for the Commodore Amiga Copyright 1991, 1993, 1994 Jack J. Woehr
  2. jax@well.sf.ca.us jax@cygnus.com SYSOP RCFB (303) 278-0364
  3. -----------------------------------------------------------------------
  4. This is free software and can be modified and redistributed under
  5. certain conditions described in the file COPYING.TXT. The
  6. Disclaimer of Warranty and License for this free software are also
  7. contained in the file COPYING.TXT.
  8.  
  9. This is Jax's free ANS Forth for the Commodore Amiga. For more information
  10. on ANS Forth, contact the X3J14 Technical Committee via email at
  11.  
  12.     ansforth-request@minerva.com
  13.  
  14. or contact the
  15.  
  16.     American National Standards Institute
  17.     11 W. 42nd Street
  18.     New York NY 10036
  19.  
  20. The source and documentation were prepared using Amiga MicroEmacs.
  21.  
  22. Listing of archive:  'JX4A0317.LZH'
  23. Original Packed Ratio  Date     Time   Type  CRC  Name
  24. -------- ------  --- -------- -------- ----- ---- ------------
  25.    15230   6277  59% 05-17-94 13:22:26 -lh1- 38BF COPYING.TXT
  26.     1827    853  54% 05-17-94 13:22:14 -lh1- 58F4 DEFIMAGE.A
  27.   131280   2953  98% 05-17-94 13:22:24 -lh1- 50CB DEFIMAGE.JX4
  28.       52     43  18% 05-17-94 13:22:12 -lh1- B73C DEFIMAGE.LNK
  29.       94     74  22% 05-17-94 13:22:12 -lh1- DD3A DEFIMAGE.MAKE
  30.       92     62  33% 05-17-94 13:22:12 -lh1- 3BA8 DEFIMAGE.WITH
  31.    37188  18371  51% 05-17-94 13:22:16 -lh1- 1E16 JAX4TH
  32.   193700  60208  69% 05-17-94 13:22:10 -lh1- 88D9 JAX4TH.A
  33.    14329   5648  61% 05-17-94 13:22:00 -lh1- 90A1 JAX4TH.I
  34.       43     37  14% 05-17-94 13:21:58 -lh1- 3AE9 JAX4TH.LNK
  35.      168    113  33% 05-17-94 13:21:58 -lh1- 30C8 JAX4TH.MAKE
  36.       65     51  22% 05-17-94 13:22:00 -lh1- AE5D JAX4TH.WITH
  37.       26     24   8% 05-17-94 13:21:58 -lh1- B96C MAKEALL
  38.     5237   1936  64% 05-17-94 13:22:32 -lh1- 9734 demo/DEMO.F
  39.      436    318  28% 05-17-94 13:22:30 -lh1- 5D7F doc/JAX4TH.BUGS
  40.    33704  14149  59% 05-17-94 13:22:28 -lh1- 2DDD doc/JAX4TH.DOC
  41.     2462   1094  56% 05-17-94 13:22:28 -lh1- 7B80 doc/JAX4TH.INTERNALS
  42.    19267   7664  61% 05-17-94 13:22:30 -lh1- 3327 doc/JAX4TH.WORDS
  43.     6684   3202  53% 05-17-94 13:43:06 -lh1- EEA1 READ_1ST.TXT
  44. -------- ------  ---
  45.   461884 123077  74%       19 file(s)
  46. Operation successful
  47.  
  48. Files in this distribution
  49. --------------------------
  50. DEFIMAGE.A
  51. C.A.P.E. source code for the default local image of JAX4TH.
  52.  
  53. DEFIMAGE.JX4
  54. The default local image to be loaded by JAX4TH in the case of the
  55. latter's being invoked from a command line interface without an image
  56. file argument. In later versions, double-clicking <name>.JX4.info will
  57. invoke JAX4TH on the given image.
  58.  
  59. DEFIMAGE.LNK
  60. Link commands for linking DEFIMAGE.JX4.
  61.  
  62. DEFIMAGE.MAKE
  63. Amiga script file to make DEFIMAGE.JX4.
  64.  
  65. DEFIMAGE.WITH
  66. A "with" file for the linking process.
  67.  
  68. DISTRIB.TXT
  69. This description of the current distribution and restrictions (if any)
  70. on re-distribution by the user.
  71.  
  72. JAX4TH
  73. Relocatable re-entrant dpANS-2-compliant Forth kernel suitable
  74. for PURE bit protection under AmigaDOS.
  75.  
  76. JAX4TH.A
  77. C.A.P.E. source code for the re-entrant kernel JAX4TH.
  78.  
  79. JAX4TH.BUGS
  80. Some bugs from the known bug list.
  81.  
  82. JAX4TH.I
  83. Includes, macros for JAX4TH.A and DEFIMAGE.A.
  84.  
  85. JAX4TH.DOC
  86. An informational file which assumes 1) that the reader has
  87. systems programmer familiarity with the Commodore Amiga 500/1000/200,
  88. and 2) that the reader is familiar with Forth, and with the particulars
  89. of the draft proposed ANS Forth promulgated by the ANS X3/X3J14 Technical
  90. Committee for an American National Standard Forth.
  91.  
  92. JAX4TH.LNK
  93. Linker command file for JAX4TH.
  94.  
  95. JAX4TH.MAKE
  96. Amiga script file to make JAX4TH.
  97.  
  98. JAX4TH.WITH
  99.  
  100. A "with" file for the linking process.
  101.  
  102. JAX4TH.WORDS
  103. This is a listing with stack diagrams of the words in the FORTH-WORDLIST
  104. and a listing with stack diagrams and explanations of the words in the
  105. IMPLEMENTOR-WORDLIST.
  106.  
  107. Also ...
  108.  
  109. COPYING.TXT
  110. The GNU Public License.
  111.  
  112. READ_1ST.TXT
  113. This file.
  114.  
  115. Quickstart Instructions
  116. -----------------------
  117.  
  118.     1) Make a logical device (e.g., via AmigaDOS ASSIGN) name JX4:
  119.  
  120.     2) Copy JAX4TH and DEFIMAGE.JX4 to JX4:
  121.  
  122.     3) Optionally, at the AmigaDOS prompt type
  123.  
  124.         RESIDENT JX4:JAX4TH
  125.  
  126.     to make JAX4TH resident
  127.  
  128.     4) From a NEWCON: (NewShell) window, type
  129.  
  130.         JAX4TH
  131.  
  132.     to launch an instance of JAX4TH. You can launch as many
  133.     instances from as many NewShell windows as you like. Type
  134.     INSTANCES in JAX4TH and it will return on the stack the number
  135.     of instances of JAX4TH currently running. DO NOT "RUN" JAX4TH.
  136.  
  137.     5) BYE exits the current instance of JAX4TH and decrements INSTANCES
  138.     but does not clean up any resources allocated by the programmer: open
  139.     files, allocations via the MEMORY wordlist words, resources allocated
  140.     via direct CALLs to the Amiga operating system, etc. must be cleaned
  141.     up by the program.
  142.  
  143. BUGS
  144. ------
  145. See JAX4TH.BUGS
  146.  
  147. THANX
  148. -----
  149.     - To Steven Sarns, President of Vesta Technology, for his
  150.     support of X3J14 and my attendance thereto.
  151.  
  152.     - To Steven R. Wheeler for moral support, clever suggestions,
  153.     and debugging assistance.
  154.  
  155.     - To all the members of X3J14 and to chair E. Rather,
  156.     to vice-chair Andy Kobziar, and to TSC chair G. Bailey.
  157.  
  158.     - To Wil Baden, Forth Algorithmist Emeritus.
  159.  
  160.     - To Peter Appelman, a friend.
  161.  
  162.     - To the members of the Forth Interest Group, who taught
  163.     me Forth and gave me a new career.
  164.  
  165.     - To Darren & BJ of AMIGA PRO/AM on GEnie, who in 1989 asked me
  166.     the $64,000 question, "A Forth load library? Why? Why not just
  167.     write a PURE RESIDENT-able Forth?"
  168.  
  169.     - To Wes Howe and to Innovatronics for C.A.P.E.
  170.  
  171.     - and lastest and mostest, To my wife and children, who accept
  172.     that Dad stays up late a lot in the basement.
  173.  
  174. << END of DISTRIB.TXT >>
  175.  
  176. Release notes:
  177.  
  178. 0.dpANS-6.3.16    - dpANS-6 compliance. Fixed bug which prevented control
  179.         structures from spanning lines in INCLUDED files.
  180.  
  181. 0.dpANS-2.3.11    - fixed bug in system calls to Amiga OS.
  182.  
  183. 0.dpANS-2.3.10    - Fixed some minor bugs.
  184.  
  185. 0.dpANS-2.3.08    - Added SAVE-IMAGE and AUTOSTART to effect saving custom
  186.           images for later reload and autostart.
  187.  
  188. 0.dpANS-2.3.06    - Added command-line loading of custom image file. Minor
  189.           bug fixes.
  190.  
  191. 0.dpANS-2.3.04    -  S"  now complies with the description in the FILE
  192.            wordlist, i.e., it works interpretively at not just
  193.            as a compilation tool.
  194.  
  195. 0.dpANS-2.3.03    -  J   fixed, wouldn't work inside branch constructs.
  196.  
  197. 0.dpANS-2.3.02    -  I   fixed, wouldn't work inside branch constructs.
  198.         -  M*  was accidentally non-findable, now findable.
  199.  
  200. 0.dpANS-2.3.01    -  CALL  to Amiga OS now supported, see JAX4TH.DOC and
  201.           JAX4TH.WORDS. 91-09-07.
  202.  
  203. 0.dpANS-2.2.28    - First public release 91-09-01.
  204.  
  205. BUG REPORTS AND SUGGESTED IMPROVEMENTS TO:
  206. Jax
  207. PO Box 51
  208. Golden, CO 80402-0051
  209. jax@cygnus.com    <<== preferred
  210. jax@well.sf.ca.us
  211. 72203.1320@compuserve.com
  212.